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THE DIMENSION COPROCESSOR CONCEPT 

Application software is the most important component of any microcompu- 
ter system. Previously, the microcomputer's operating system and pro- 
cessor dictated the available choice of software for a given applica- 
tion. The Dimension Coprocessor System enables you to choose from a 
larger variety of programs and operating systems. By using coprocessors 
and a technique known as emulation, the DIMENSION 68000 can be made to 
run programs written for many machines. 

The Dimension Z-80 Coprocessor enables a large library of programs and 
operating systems written for the KayPro II, for the Croitiemco, for the 
Osborne I, and for a generic CP/M-80 machine to be run on the DIMENSION 
68000 Computer. Emulation software and a dedicated Z-80 microprocessor 
(which is similar to the 8080) along with your DIMENSION 68000 computer 
system enables you to take advantage of the many quality programs writ- 
ten for CP/M-80 based machines in general. 



USER SUPPLIED SOFTWARE, A PART OF THE COPROCESSOR SYSTEM 

To utilize the Z-80 Coprocessor requires the purchasing of an operating 
system and/or purchasing (or writing) the programs necessary to perform 
the application that is desired. Operating systems such as CP/M-80 are 
available from many computer dealers, as well as many application pro- 
grams that are specific to your needs. The Z-80 Coprocessor system, 
when combined with a powerful operating system and with the necessary 
application programs, becomes a valuable addition to the DIMENSION 
68000 computer system. 

Computer users, with large libraries of CP/M-80 (or equivalent) soft- 
ware, can move up to the power of the DIMENSION 68000 without losing 
their investment in software. Most custom programs that are written for 
the CP/M-80 operating system will run without change on the Z-80 Copro- 
cessor with the appropriate Emulator. 
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MANUAL USAGE 

The information contained in this manual documents the Z-80 Coprocessor 
and the procedures required for its use as an Emulator. In order to 
to fully apply the Coprocessor System, additional information may be 
required. In most cases, adequate documentation for the experienced 
user is included with the purchase of those programs. For the neophyte, 
however, the purchase of tutorial materials is strongly recommended. 

The following symbols will be presented throughout this manual to aid 
understanding : 

** Suggestions, reminders, and helpful hints will be noted by 
a ** symbol . 

*** WARNING *** 

indicates a possible source of danger to you, your equipment, 
or your software. 

<CR> or (no <CR>) Indicates when the RETURN key should (or 
should not) be pressed. 

(") Indicates when a CONTROL character should be typed. 
"Ctrl" stands for CONTROL. As an example, C^C) is typed by 
holding the "Ctrl" key down, pressing the "C" key, releasing 
the "C" key, and finally releasing the "Ctrl" key. 

Computer screen responses will look like this example: 

Micro Craft Operating System - CP/M-68K copyright DIGITAL RESEARCH Inc. 1983 
Bios version X.X Copyright Micro Craft Corp. 1983, 1984 

In this manual, entries that are to be made, are shown in the context 
of the entire line as it is displayed on the screen. The part that you 
are to enter is shown in bold characters 

BEFORE YOU BEGIN. . . 

If you are unfamiliar with the DIMENSION 68000 computer, you should 
refer to the "DIMENSION 68000 System User's Guide" that is supplied 
with your unit. Installation and operation, of your computer system, is 
described in detail. You should be familiar with the machine before you 
attempt to install the Coprocessor hardware and software. 
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If you are new to the CP/M-68K operating system, the "CP/M-68K User's 
Guide" supplied with your DIMENSION 68000 explains the CP/M-68K opera- 
ting system commands and syntax. References are made to certain CP/M 
68K commands in order to install the Z-80 Coprocessor software. 
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INSTALLATION OF YOUR Z-80 COPROCESSOR 

If you are familiar with the DIMENSION 68000 and the basic commands of 
the CP/M-68K operating system, then you are ready to begin installation 
of your Z-80 Coprocessor circuit board. This chapter explains how to 
install your Dimension Z-80 Coprocessor circuit board into your DIMEN- 
SION 68000 computer system. 

PACKAGE CONTENTS 

your Z-80 Coprocessor System contains the following: 

1) A Z-80 Coprocessor Reference Manual 
Part number 680-0004-100 

2) A Z-80 Coprocessor Circuit Board 
Part number 200-0008-001 

3) A MASTER EMULATION diskette 
Part number 310-0004-100 

4) A Product Registration/Warranty Card 
Part number 600-0014-103 

If any of the above items are missing, contact your dealer for replace- 
ment. 



SYSTEM REQUIREMENTS 

In order to install your Z-80 Coprocessor System, the following equip- 
ment and materials will be required: 

1) A DIMENSION 68000 with a minimum of 256K memory 

2) A Dimension Z-80 Coprocessor circuit board 

3) Two - 40 track, 5 1/4 inch, diskette drives 

4) A video monitor 

5) A Dimension "SYSTEM 1" or other CP/M-68K System Master diskette 

6) A MASTER EMULATION diskette 

7) Blank diskettes 

8) A #2 (medium) Phillips head screwdriver 

In addition to the above, an application program for the Z-80 Coproces- 
sor/Emulator is required to use the unit, but is not necessary for in- 
stallation or for initial checkout. Application programs may be pur- 
chased from your computer dealer. 
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COPROCESSOR CIRCUIT BOARD INSTALLATION 

In order to install the Z-80 Coprocessor circuit board in the DIMENSION 
68000, the top cover, of the SYSTEM UNIT, will need to be removed. Then 
you must plug the Z-80 Coprocessor board into one of the expansion con- 
nectors. Finally the top cover is replaced. 

Remove any diskettes from the disk drives and move other loose objects 
from around the machine. Disconnect the Video Monitor and monitor cable 
and set thfem aside. Disconnect the power cord from the DIMENSION 68000 
back panel and unplug it from the wall. It is not necessary to discon- 
nect the keyboard, but remove any cables or items which restrict the 
movement of the machine. 

The top cover of the SYSTEM UNIT is attached, to the bottom cover, by 6 
screws that are recessed into the bottom cover and that are fixed into 
the case to prevent the screws being lost. To remove the top cover, the 
following steps are recommended: 

- TURN OFF the DIMENSION 68000 system. 

- DISCONNECT the power cord from the Dimension SYSTEM UNIT. 

- MOVE the unit to the edge of the table or desk so that it is sitting 
with one side (left or right) facing you. 

- Use a #2 Phillips screwdriver (the shank of the screwdriver must be 
at least 3 1/2 inches long) to LOOSEN the screws. The screws will NOT 
fall out, but you will be able to tell, by the feel, when they are 
loose. 

- When all 3 screws are loose, TURN THE UNIT so that you can reach the 
3 screws on the other side and LOOSEN THEM. When all of the screws 
have been loosened, then the top cover of the housing can be lifted 
off to expose the inside of the DIMENSION 68000. 

- REMOVE the top cover carefully and be sure to PLACE IT where it will 
not fall, get scratched, or be stepped on. (As a separate piece, the 
top cover is not nearly as rugged as the assembled unit.) 
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PLUGGUNG IN THE Z-80 COPROCESSOR CIRCUIT BOARD 

*** WARNING *** 

Static Electricity can damage sensitive computer components. 

Before touching anything inside the case or the Z-80 circuit 
board, double check to make certain that the power cord is 
disconnected and the power switch is off. Touch the metal 
power supply case (located to the right of the unit) with 
both hands. This action will prevent static discharge and 
damage to the system components. 
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*** WARNING *** 

The Z-80 Coprocessor circuit board is shipped in an anti- 
static plastic envelope. Make certain that you discharge any 
static that may be stored in your body before removing the 
circuit board from the protective bag. Save this bag. 

*** ANOTHER WARNING *** 

When handling the circuit board, be careful not to touch the 
gold connector at the edge of the board. Oil and moisture on 
from your fingers will contaminate the connector and create 
a poor electrical connection. 

Remove the circuit board from its protective bag and note the serial 
number of the unit which is located on the circuit board along the 
metal locking tab. 

** Record the serial number on both the warranty card and your records 
now, to prevent having to disassemble the machine later. 

The Z-80 Coprocessor circuit board may be inserted into any available 
motherboard expansion connector. When inserting the metal locking tab 
into the rear panel, make certain that the lower tip is inserted into 
the cutout at the bottom of the rear panel. The upper portion of tab 
will then be able to slide into the panel. 

The motherboard connector will offer some resistance to the seating of 
the circuit board. With firm but gentle pressure, press down on the 
circuit board until it is firmly seated in the motherboard expansion 
connector. 



Inserting the Circuit Board and Attaching the Metal Tabs 
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PUTTING THE COVER BACK ON 

Re-install the top cover of the Dimension 68000 by placing the top half 
of the case back onto the bottom half. The top cover fits smoothly over 
the disk drives in the front and around the back panel in the rear. 
Press the top half of the case until complete contact is made against 
the bottom half. Using the method described previously, re-install the 
cover screws being careful not to cross thread them. Tighten each screw 
until it is "finger tight." Do not overtighten. 

Reconnect any cables that you removed earlier. In particular, be sure 
that the video monitor is connected. This process is explained in more 
detail in the "DIMENSION 68000 System User's Guide". 

TURNING THE POWER ON TO TEST THE SYSTEM 

In this step we will turn on the power and verify that the Z-80 Copro- 
cessor Circuit Board is installed properly. Put a copy of the "SYSTEM 
1" diskette into disk drive A:. Be sure that there is a write protect 
sticker over the write protect cutout on the right side of the "SYSTEM 
1" diskette. Turn the lever on the front of disk drive A: clockwise 
until it points down. This closes the disk drive on to the diskette. DO 
NOT FORCE THE LEVER. If it will not turn easily, re-insert the diskette 
and try again. 

** When this manual says, "insert the diskette..." or "put the disk- 
ette in ... ," it is assumed that you will turn the lever on the 
diskette drive to close it. Forgetting to do this will not harm your 
computer or the diskette but the computer will not be aware that the 
diskette is in place. 

If you DO NOT have a BACKUP COPY of the "SYSTEM 1" diskette, refer to 
the "DIMENSION 68000 System User's Guide" - Appendix B and make one be- 
fore proceeding. 

The "SYSTEM 1" diskette is in drive A:. If there are any diskettes in 
diskette drive B: (or drive C:, or drive D:), then remove them at this 
time. 

If the DIMENSION 68000 computer has never been turned ON, refer to the 
"DIMENSION 68000 System Reference Manual" for connection and for ini- 
tial tests. If the system has been used prior to Coprocessor installa- 
tion, then you may proceed with the instructions to reconnect the power 
cord and switch the unit on. 

Turn on the video monitor and check both ends of the video cable. 

The power switch should be off. Plug in the power cord. If the switch 
is ON you will see the red light on the reset button come on. Turn OFF 
the power switch immediately. 
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Allow enough time for the video monitor to warm up. Then turn the power 
switch on. First the red light on the reset button will come on. Then 
the following message will be displayed. 

Welcome to the Realm 

of 

Dimension Computing 

by 

Micro Craft Corporation 

At the same time the red light, on drive A:, will come on as drive A: 
begins spinning. Finally, the screen will clear and the following mes- 
sage and prompt will be displayed. 

Micro Craft operating system- CP/M 68K Copyright DIGITAL RESEARCH Inc. 1983 
Bios version 2.2 Copyright Micro Craft Corp. 1983 
last revised mm/dd/yy 

A> 
A> 

If the first message does not appear, then check the following items. 

Is the power cord connected at both ends? 

Is the video monitor powered? 

Is the video monitor connected to the DIMENSION 68000? 

Is the brightness control on the video monitor turned up? 

If the above items seem to check out, then turn the power off, remove 
the top cover and re-check the installation of the Z-80 Coprocessor 
circuit board. Make certain that the Coprocessor circuit board is seat- 
ed firmly. If you still experience difficulty, remove the Z-80 Copro- 
cessor circuit board, and consult your dealer. 

If the second message does not appear, check the following items. 

Is the lever on drive A: closed (down)? 
Is the "SYSTEM 1" diskette in drive A:? 
Is the diskette in drive A: a good copy? 

Again, if these items seem to check out, then turn off the power, re- 
move the top cover, and re-check the installation of the Dimension Z-80 
Coprocessor circuit board. Make certain that the Z-80 Coprocessor cir- 
cuit board is seated firmly. If you still experience difficulty, remove 
the Z-80 Coprocessor circuit board, and consult your dealer. 
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DISKETTE BACKUP, COPROCESSOR SYSTEM MASTER CREATION 

The system software for your Z-80 Coprocessor system is supplied on an 
MASTER EMULATION diskette. To properly and efficiently utilize the Z-80 
Coprocessor, requires the creation of a Coprocessor SYSTEM MASTER disk- 
ette from an MASTER EMULATION diskette. 

The CP/M-68K operating system and other useful programs will be instal- 
led as you create your Coprocessor SYSTEM MASTER diskette. These pro- 
grams will; simplify making additional WORK copies of your Coprocessor 
SYSTEM MASTER diskette, enable your backup work copies to be "booted", 
and ease installation of the Coprocessor software. 

Your Coprocessor SYSTEM MASTER will be used later for the installation 
of the emulation software. The creation of a Coprocessor STSTEM MASTER 
diskette is essential before you proceed with system startup. DO NOT 
use ANY original or MASTER EMULATION diskette as a work copy. An error 
on your part or a malfunction in your DIMENSION 68000 Computer (no mat- 
ter how rare either may occur) could damage the diskette you are using, 
even with the write protect sticker in place. To obtain a replacement 
from your dealer is expensive and much more inconvenient than the mak- 
ing of a copy from the "master" that you have stored in your desk. 

** If you are not familiar with the CP/M-68K operating system you may 
wish to refer to the "DIMENSION 68000 System User's Guide" and the 
"CP/M-68K User's Guide" that is supplied with your DIMENSION 68000 
before proceeding. 

Creation of the Coprocessor System Master diskette is performed under 
the CP/M-68K operating system. Make certain that a copy of the "SYSTEM 
1" diskette is in drive A:. Turn off the DIMENSION 68000 (if it is on). 
Wait 5 to 10 seconds and turn it back on. This will "boot" the system. 
"Booting" the system loads the CP/M 68K Operating System into the com- 
puter memory. 

When CP/M-68K is initially loaded, the following information will be 
displayed: 

icro Craft Operating System - CP/M-68K copyright DIGITAL RESEARCH Inc. 1983 
ios version 2.2 Copyright Micro Craft Corp. 1983 
last revised MM/DD/YY 

> 
> 
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FORMATTING A DISKETTE 

It is recommended that the System Master diskettes and the Turn-Key Em- 
ulation Master diskettes be formatted in the Micro Craft 40 Track Stan- 
dard format. If you need instructions on formatting a diskette, there 
are detailed instructions in the "DIMENSION 68000 System User's Guide." 

INSTALLATION OF CP/M 68K AND UTILITIES 

Now you will need to create a "bootable" backup diskette from the for- 
matted diskette that was created earlier. Leave the "SYSTEM 1" diskette 
in drive A: and the newly formatted (but really still blank) diskette 
in drive B:. Enter the following command to copy the contents of the 
"boot" track on the diskette in drive A: to the diskette in drive B: . 

A>COPY BOOT A B [v]<CR> 

** The [V] option [V]erifies the operation and should be included to 
make certain that the boot track was copied properly. 

The system will respond: 

Copy Ver 1.1 

CC to ABORT) 

RETURN to copy BOOT from A to B 

If the command was entered properly, press the "Retrn" key (<CR>) to 
continue. If it was not, type ''C (Ctrl and C) to return to CP/M-68K 
(with the A> prompt) and re-enter the COPY BOOT A B command. 

When you press the "Retrn" key the system will respond: 

*** Copying Tracks *** 


Copy complete 

The system will ask the following question. 

Do you wish to repeat the copy? 

To exit, enter the following response. 

N <CR> 

The system will return to CP/M 68K, showing the following prompt. 

A> 

The diskette in drive B: is now formatted and half-way "bootable." The 
next step is to install the CP/M-68K Operating System and the optional 
submit program. A submit program will be used in a later section to en- 
able the system to automatically load the emulation programs. 
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To install the CP/M-68K operating system, enter the following command. 

A>PIP B;=A:CPM.SYS[V]<CR> 

** The [V] option [V]erifies the operation and should be included to 
make certain that the file was copied properly. 

If the copy is successful, the system will return to CP/M-68K after 20 
to 30 seconds and return the following prompt. 

A> 

If the prompt is not all that is printed at this point, an error mes- 
sage may indicate what the problem is. The "CP/M 68K Operating System 
User's Guide" explains more about the use of PIP and the possible error 
messages. 

** If you experience difficulty, make certain that the PIP command was 
typed exactly as shown including all spaces. 

To install the default (i.e. empty) submit program, enter the following 
command . 

A>PIP B:=A:CPMCONF.SUB[v]<CR> 

Again, the prompt should be returned. 

A> 

Before we begin the next step (creating a Coprocessor SYSTEM MASTER and 
the backup of the EMULATION MASTER distribution diskette) , an addition- 
al file will need to be copied onto the newly created SYSTEM MASTER 
diskette in drive B:. This file, named PIP.68K, contains the program 
that will be used to copy the emulation programs. PIP has been used in 
the previous steps to copy the CP/M-68K operating system and Submit 
file from drive A: to drive B: . PIP can also be used to copy the file 
containing itself. 

To copy PIP from drive A: to drive B:, enter the following command. 

A>PIP Bl=A:PIP.68K[V]<CR> 

And CP/M 68K will again respond with the prompt. 

A> 

The "bootable" CP/M 68K system diskette (with PIP installed) that has 
just been created in drive B: is now ready for you to copy onto it the 
Z-80 Emulator software. 
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Log on to drive B: , by entering the command. 

A>B:<CR> 

The system will respond with the following prompt. 

B> 

Remove the "SYSTEM 1" diskette from drive A:. Insert the original EMU- 
LATOR MASTER distribution diskette into drive A:. Make sure that a 
write protect sticker is in place over the write protect cutout on the 
right side of this original EMULATOR MASTER distribution diskette. 

To backup the EMULATOR MASTER diskette in drive A:, its contents are 
copied onto the new diskette that is in drive B:, by this command. 

B>PIP B:=A:CPM80.68K[ov]<CR> 

Then this command is issued. 

B>PIP B:=A:KAYPR02.68K[ov]<CR> 

And, then this command is issued. 

B>PIP B:=A:CROMEM3.68K[ov]<CR> 

Lastly, then this command is issued. 

B>PIP B:=A:OSBORNE1.68K[ov]<CR> 

Make certain that you include the [o] (letter 0) option or your Emula- 
tion Coprocessor [0]bject files may not be copied correctly. 

After each copy, the system will respond with: 

B> 

To verify that the preceding files have been copied and are contained 
on drive B:, enter the following command. 

DIR B:<CR> 

The system should display the following directory: 

B:CPM SYS : CPMCONF SUB : PIP 68K : KAYPR02 68K : CPM80 68K 

CR0MEM3 68K : OSBORNEl 68K 
B> 

Install a write protect sticker on the new Emulation System Master 
diskette to prevent accidental erasure. This diskette should be used 
for installation, copies, and all future system maintenence. The origi- 
nal Distribution Diskette should be stored in a safe place, away from 
your computer. It should only be used to restore your Emulation System 
Master if it is damaged or lost. 
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You should make several copies of the new Coprocessor SYSTEM MASTER 
diskette at this time. Save the first Coprocessor SYSTEM MASTER away 
with the original MASTER EMULATION diskette. Now you will not need to 
repeat the whole installation process in case your work copy is ruined 
in some way. 

** Children, animals, magnets, and most electric appliances are nat- 
ural enemies of the information on your diskettes. Keep them away 
from your master diskettes. 

** Appendix B of the "DIMENSION 68000 System User's Guide" describes 
how to make backup copies of diskettes. 

At this point your Coprocessor SYSTEM MASTER diskette is ready to be 
used in the further installation process that is outlined in later sec- 
tions. 



CREATING A TURN-KEY EMULATION DISKETTE 

If you wish to dedicate your DIMENSION 68000 and Z-80 Coprocessor Sys- 
tem as an Emulator you will want to create a TURN-KEY EMULATOR DISKETTE 
from a copy of your Coprocessor SYSTEM MASTER. 

** A turn-key system using a submit file is recommended for "emulation 
only" diskettes to prevent the operator from being required to enter 
or learn CP/M 68K commands. 

This section explains how to create a submit file to tell CP/M 68K that 
you want to perform Emulation when your DIMENSION 68000 is first turned 
on. This makes the diskette with the submit file and the Emulator pro- 
grams a TURN-KEY EMULATOR diskette. 

A "turn-key" system has the advantage of requiring a minimum of opera- 
tor intervention at the CP/M 68K command level. Users who are not fami- 
liar with the DIMENSION 68000 or the CP/M 68K operating system do not 
have to learn the necessary commands to start Emulation. 

A "turn-key" system allows you to begin emulation immediately upon 
turning on the power switch of your DIMENSION 68000. The term "turn- 
key" is used because some, older, computers used a locking "key" to 
turn the power on. A "turn-key" system would begin running immediately 
upon "turning the key" on. Your Dimension 68000 has a simple ON-OFF 
switch for that purpose, but the term "turn-key" is still with us. 

When the submit file in the following example is installed, all that is 
required to begin emulation is that the operator take out the diskettes 
that are in the drives and insert the diskettes that have the CP/M 2.2 
format, when the Emulator Welcome Menu indicates that it is time to do 
so. 
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There is a file, named CPMCONF.SUB, that is on the Coprocessor SYSTEM 
MASTER, on the copies of the Coprocessor SYSTEM MASTER, on the "SYSTEM 
1" diskette, and on the copies of the "SYSTEM 1" diskette. When the 
power is turned on, or a disk is "booted", the CP/M 68K operating sys- 
tem is loaded. The first action of CP/M 68K (upon being loaded) is to 
examine the submit file, named CPMCONF.SUB, to see what further action 
should be taken. 

The CPMCONF.SUB file on your Coprocessor SYSTEM MASTER diskette and the 
copies made from it does not contain any instructions. When CP/M 68K is 
loaded, control is passed immediately back to the operating system by 
the submit file and the A> prompt is returned. 

The CPMCONF.SUB submit file on your work diskettes may be modified to 
"type" commands for you and to load the Z-80 Emulation program for you. 

** If you have any questions regarding the use of submit files or have 
a diskette which has already been modified, refer to the "CP/M 68K 
User's Guide" supplied with your DIMENSION 68000. 

To enter commands into the CPMCONF.SUB file, the ED text (ED) itor util- 
ity on your CP/M 68K System Master diskette will be used. 

** Documentation of ED, the text editor utility, is contained in your 
"CP/M 68K user's Guide". 

The Coprocessor SYSTEM MASTER work diskettes, that you have created, 
are the^ diskettes that you should use to install the submit file. 

- PUT the diskette, on which you wish to install the submit file, into 
drive B: . 

- REMOVE the write protect sticker from this diskette temporarily. 

- PUT a "SYSTEM 1" diskette copy, that contains the file ED.68K, into 
drive A: . 

- LOG ON to drive A:, if necessary, by entering the following command. 

B>A:<CR> 

The system will then display the prompt: 

A> 

** If you make a typing mistake, while in ED, you may press the Back- 
space key to delete the last character. 

To load the ED program and to edit the CPMCONF.SUB file on the Copro- 
cessor SYSTEM MASTER in drive B:, enter the following command. 

A>ED B:CPMCONF.SUB<CR> 

ED will display it's normal prompt character, which is a colon. 
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To Append to the existing CPMCONF.SUB file and to Insert the new com- 
mands, enter the following commands. 

:*500A<CR> 

:*I<CR> (Note: you should not type spaces before the <CR>) 

ED will return: 

1: 

Type the filename of the emulation program followed by any options that 
you wish to use. For the Z-80 Emulator, you should enter one of the 
following commands. 

CPM80.68K<CR> 

KAYPR02.68K<CR> 

CROMEM3.68K<CR> 

OSBORNEl.68K<CR> 

The ED program will respond with the following prompt. 

2: 

To end the entering information using the ED program, enter the follow- 
ing command. 

2:^2 (No <CR>) (CONTROL Z, NO RETURN) 

The ED program will return the following prompt. 



To exit the ED program, enter the following command. 

:*E<CR> 

The ED program will then save the modified submit file onto the disk- 
ette in drive B: . 

** The name of the original, empty, submit file will be changed to 
CPMCONF.BAK. 

The CP/M system will then display the following prompt. 

A> 
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The previous operations are summarized below: 



A> ED B:CPMCONF.SUB<CR> 

:* 500A<CR> 

:* I<CR> 
1: CPM80.68K<CR> 
2: <"Z><CR> 

:* E<CR> 



edit CPMCONF.SUB file on drive B: 

append existing submit file 

insert new information 

filename of desired emulation program 

K^zy CONTROL-Z to finish 

Exit ED 



A> 



The modified submit file on drive B: , may now be used to load the IBM 
PC Emulation program, when you turn on the power, with the "Turn-Key" 
Emulator diskette in drive A: . 

Put the write protect sticker back on the "Turn-Key" diskette in drive 
B:. 

Submit files have many other powerful applications. To learn more about 
submit files, refer to the "CP/M 68K User's Guide". 

** CP/M 68K submit files cannot be used or have control after the emu- 
lation mode is entered. 
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USING THE Z-80 COPROCESSOR AS AN EMULATOR 



To use the Z-80 Coprocessor as a CP/M 2.2 System, that will emulate a 
KayPro II, a Cromemco, an Osborne I, or a generic CP/M 2.2 system 
requires either a Coprocessor SYSTEM MASTER diskette or a Turn-Key Emu- 
lator diskette. Chapter 2 describes how to create either type of disk- 
ette. Either type of diskette will require that the Z-80 Coprocessor 
Software must be installed. 

If you do not have a Coprocessor SYSTEM MASTER diskette or a Turn-Key 
Emulator diskette, then you need to make one at this time. DO NOT use 
the original EMULATION MASTER distribution diskette. Information on 
making copies of the EMULATION MASTER diskette and on creating a Turn- 
Key diskette is contained in the previous chapter. 

EMULATION HARDWARE INTERFACE CONFIGURATION 

The Z-80 Coprocessor Emulation software supports the following inter- 
face "adapters" and peripherals: 

64K bytes of Memory 

(2) 40 Track, 5 1/4 inch. Dual sided. Diskette Drives 

(1) Parallel Printer Interface 

(1) ADM-3 monochrome video display 

** Only the "CPM80" emulator will support disk drives C: , D:, E:, F: , 
G:, H:, and K: . (Drive K: is the RAMDISK.) The "KAYPRO", "CROMEMCO", 
and "OSBORNE" emulators will ONLY support disk drives A: and B: . 

** All of the Z-80 Emulator programs require that drives A: and B: both 
be 40 Track diskette drives. 

INSTALLATION OF EMULATION PROGRAMS 

The procedure, for installation of the emulation software, is determin- 
ed by the intended application of the DIMENSION 68000 and the Z-80 CP/M 
Coprocessor System. 

If it is desired to use the DIMENSION 68000 exclusively as a Z-80 CP/M 
Emulator, then it will be preferable to use a Turn-key Emulator disk- 
ette, as previously described. If it is desired to use the DIMENSION 
68000 to emvjilate a Z-80 CP/M system on an occasional basis only, then 
it will be preferable to use a Coprocessor SYSTEM MASTER diskette, as 
previously described. 

If it is desired to use the DIMENSION 68000 to emulate a Z-80 CP/M sys- 
tem and also operate under CP/M 68K, then it will be preferable to move 
a copy of the emulation software to a work copy of the "SYSTEM 1" disk- 
ette, as described below. 



CHAPTER 3 
Z-80 COPROCESSOR & EMULATORS MANUAL 



VERSION 0.00 

Page 26 

MOVING EMULATION PROGRAMS ONTO A DIMENSION "SYSTEM 1" DISKETTE 

Make certain that it is a WORK COPY of the "SYSTEM 1" diskette that is 
being used, and that it is in drive A:. (The procedure for copying the 
"SYSTEM 1" diskette is in the APPENDIX titled BACKING UP in the "DIMEN- 
SION 68000 System user's Guide".) Also, make sure that a copy of the 
Emulation Master diskette is in drive B: . And, make sure that CP/M 68K 
is loaded. The system will be displaying the following prompt: 

A> 

Use the PIP program to copy the Emulation software from drive B: to the 
CP/M 68K System Disk in drive A:, by entering the following command. 

A>PIP A:=B:CPM80.68K[ov]<CR> 

Then enter the following command. 

A>PIP A:=B:KAYPR02.68K[ov]<CR> 

And, then enter the following command. 

A>PIP A:=B:OSBORNE1.68K[ov]<CR> 

Lastly, then enter the following command. 

A>PIP A:CROMEM3.68k[ov]<CR> 

** Be sure to include all spaces as well as the [ov] options. The let- 
ter option copies [0]bject files to insure that all of the emula- 
tion program file is copied correctly. 

The system should return this prompt at the end of each copy operation 
is finished. 

A> 

If the A> prompt is not all that is returned, read the error message 
and check the typing of the command line. If that fails, "re-boot" and 
try again. 

** It is possible that some files may have to be removed from the "SYS- 
TEM 1" diskette before there will be room for one or more of the Em- 
ulation programs. Use the CP/M 68K command ERA to remove files. 

The Z-80 Coprocessor Emulation programs are now on the "SYSTEM 1" disk- 
ette. To check the diskette directory, enter the following command. 

A>DIR A:<CR> 
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Other programs, originally on the diskette, will also be shown in the 
directory. if any of the files CPM80.68K, OSBORNE1.68K, KAYPR02.68K, or 
CROMEM3.68K is present, then the "SYSTEM 1" diskette is ready to be 
used for emulation. 

USING YOUR EMULATOR 

The Dimension Z-80 Coprocessor System, when used as a Z-80 CP/M system 
Emulator, includes the CP/M-80 operating system (the CP/M that is for 
the Z-80 processor) . You will only need the necessary application soft- 
ware before the Z-80 Coprocessor can be used. Your dealer can provide 
assistance with selecting the best software for your application. 

BEFORE YOU BEGIN. . . 

During emulation, the DIMENSION 68000 assumes the personality of the 
selected Z-80 CP/M system. System operation, in the emulation mode, is 
determined by the application program and by the CP/M 2.2 operating 
system. It will be necessary to refer to the information provided with 
the programs for documentation on the operation of those programs. 

When in the emulation mode, the system will expect a disk in the format 
that corresponds to the emulator that was selected. The formats are 
listed below. It will be necessary, to start out the selected emulator, 
with a "bootable" diskette for the emulator selected. Only the "CPM80" 
emulator, will read Dimension Standard, 40 Track, CP/M-68K, diskettes. 
The other emulators will not read Dimension Standard, 40 Track, CP/M 
68K, diskettes. 

Emulator Disk Format 



CPM80 Dimension Standard 40 Track 

KAYPRO KayPro II 

CROMEMCO Cromemco 

OSBORNE Osborne I 



LOADING EMULATION PROGRAMS 



All of the emulator' programs are loaded by CP/M 68K. When CP/M 68K fin- 
ishes loading the program, tne system is converted to the emulation 
mode. If the emulator loaded is NOT the "CPM80" emulator program, the 
format for diskette drives A: and B: will be changed to the format that 
matches the emulator. 

There are two ways to begin Z-80 CP/M Emulation. These two ways are the 
same from the point of view of the computer, but you may find one of 
them to be preferable. The first way is to use a "bootable" CP/M 68K 
systems diskette, with the selected Z-80 CP/M Emulator installed as a 
Turn-Key program. 
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The second way is to begin the desired Z-80 CP/M Emulator directly from 
the keyboard while in CP/M 68K. A copy of the Coprocessor SYSTEM MASTER 
diskette is used to begin the desired Z-80 CP/M Emulation in this way. 
If a Turn-Key system is being used, put the Emulator Turn-Key diskette 
into drive A: and "boot." (Either turn on the power switch on the DI- 
MENSION 68000, or if the power is already on, press the RESET button on 
the DIMENSION 68000 front panel, and then enter: bt(no <CR>) ) . Just ig- 
nore the things that flash across the screen. 

If a Turn-key Emulator diskette is NOT being used, or if it is NOT de- 
sirable to "re-boot" the system, make certain that CP/M 68K is loaded. 
Disable the Spooler and Ramdisk if they are enabled. Only the "CPM80" 
emulator can use the Ramdisk. (Use the commands: RAMDISK and SPOOL 
to disable them.) Log on to the drive that contains the Z-80 Coproces- 
sor emulation software. If it is installed on a "SYSTEM 1" diskette, 
then it should be in drive A:. If an Emulator diskette is specified, 
then it may be in any available drive as long as the drive is speci- 
fied. 

As an example, if the system is logged on to drive A: and the software 
is on drive B:, the system will display the following prompt. 

A> 

To log on to drive B:, enter the following command. 

A>B:<CR> 

The system will then display the prompt: 

B> 

To load a Z-80 CP/M Emulator program and begin emulation, after logging 
on to the drive with the Emulator software, enter one of the following 
commands. 

For the generic Z-80 CP/M 2.2 emulator, enter the following command. 

B>CPM80<CR> 

For the Kaypro II emulator, enter the following command. 

B>KAYPR02<CR> 

For the Cromemco emulator, enter the following command. 

B>CR0MEM3<CR> 

For the Osborne I emulator, enter the following command. 

B>OSBORNE1<CR> 
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** The drive, on which the software is located, may also be specified 
and the Emulator program may be started without changing the default 
drive by entering, for example: B:CPM80<CR> 

RUNNING THE EMULATOR 

When the Z-80 CP/M Emulator "CPM80" is started, then the system will 
return this message on the 80x24 screen display: 

The Micro Craft DIMENSION 68000 
Z-80 Emulation, Ver. 1.2 
Copyright 1983 by Micro Craft Corporation 

Your Z80 configuration is; 

64K bytes of Memory 

(2) 40 track floppy disk drives 

(1) Parallel Centronics Style Printer 

(1) Console, ADM-3 terminal with Auto line feed "OFF" 

Place Boot Disk into Drive A: 
and press any key 

When the Z-80 Emulator "KAYPR02" is started, then the system will re- 
turn this message on the 80x24 screen display: 

The Micro Craft DIMENSION 68000 
KayPro II (TM) Emulation, Ver. 1.2 
Copyright 1983 by Micro Craft Corporation 

Your configuration is; 
64k bytes of Memory 

(2) 40 track floppy disk drives 

(1) Parallel Centronics Style Printer 

Place Boot Disk into Drive A: 
and press any key 
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When the Z-80 Emulator "CR0MEM3" is started, then the system will re- 
turn this message on the 80x24 screen display: 

The Micro Craft DIMENSION 68000 
Cromemco Emulation, Ver. 1.2 
Copyright 1983 by Micro Craft Corporation 

Your Z80 configuration is; 

64K bytes of Memory 

(2) 40 track floppy disk drives 

(1) Parallel Centronics Style Printer 

(1) Console, ADM-3 terminal with Auto line feed "OFF" 

Place Boot Disk into Drive A: 
and press any key 

When the Z-80 Emulator "OSBORNEl" is started, then the system will re- 
turn this message on the 80x24 screen display: 

The Micro Craft DIMENSION 68000 
Osborne Emulation, Ver. 1,2 
Copyright 1983 by Micro Craft Corporation 

Your Z80 configuration is; 
64k bytes of Memory 

(2) 40 track floppy disk drives 

(1) Parallel Centronics Style Printer 

(1) Console, ADM-3 terminal with Auto line feed "OFF" 

Place Boot Disk into Drive A: 
and press any key 
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The system is now in the emulation mode. At this point, to begin using 
the DIMENSION 68000 and the Z-80 Coprocessor as the Z-80 CP/M system 
selected, insert a diskette that is formatted, for the system speci- 
fied, in drive A: . 

If instead of getting the above message, the following message is re- 
ceived. 

No Z-80 Coprocessor Board Found 

The Z-80 Coprocessor circuit board is either not installed properly or 
it is not functioning. If it is certain that installation is correct, 
then contact your dealer for assistance. 

If instead of getting the "not-installed" message, that is shown above, 
the following message is received. 

sector id addrs mark not found 

Do YOU Want To Retry (RETRN) or Abort (ESC) ? 

Then the Z-80 CP/M Emulator software cannot read the Z-80 format disk- 
ette. A defective diskette is the most likely cause. 

Make sure that the following items are observed: 

- The DIMENSION 68000 must have 256K memory at the minimum. 

- The "SYSTEM 1" diskette or other boot diskette must be configured for 
256K Bytes of memory at the minimum. Use either the "SYS256" program, 
the "SYS384" program, or the "SYS512" program to change the memory 
configuration. 

- Unless the emulator is "CPM80", the RAMDISK and/or SPOOL should be 
disabled and removed from memory. They should be disabled by using 
the following commands. 

RAMDISK 0<CR> and SPOOL 0<CR> 

If there is a problem, check that these items are correct and then try 
starting the Z-80 Emulator again. 

Normally, the disk drive will be making sounds and eventually the wel- 
come message from the operating system (or the application program) 
will manifest itself on the screen. The screen is now that of the Z-80 
isystem that you selected. The 25th line will display one of the follow- 
ing messages. 

KayPro II Emulation of CP/M 2.2 Ver 1.2 
Z80 Emulation of CP/M 2.2 Ver 1.2 
CP/M Emulator Vsn x.xx 
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This indicates the type of computer that the DIMENSION 68000 is cur- 
rently acting like. (When a computer will emulate the Apple ] [ Plus, 
the IBM PC, the Kaypro II, and other computers, as well as having its 
own CP/M 68K, it is necessary to have a message telling what kind of 
emulation is being performed.) The 25th line does not interfere with 
the normal display that is on the screen. 

Use the DIMENSION 68000 in the selected Z-80 CP/M Emulation mode exact- 
ly as if it were the system, and not an emulation. 

LEAVING THE EMULATION MODE 

This section explains how to reset, exit, and restart emulation. 

*** WARNING *** 

NEVER exit emulation or press RESET without first saving any 
files or data being worked on. If emulation is exited or if 
the system is RESET without saving the data, the data will be 
lost. 

The DIMENSION 68000 may be reset from the front panel pushbutton, which 
is refered to as the reset-button. The reset-button will work in all 
situations. However, the reset-button is designed for EMERGENCY situa- 
tions in which no other method of restoring order to the program will 
work. 

The Z-80 Emulator may also be reset by pressing the Ctrl, Alt, and Del 
keys all at the same time. This is only available when the Z-80 Emula- 
tor is trying to read a key from the keyboard. It is designed to be 
used in situations that are less drastic than the reset-button. 

After pressing the reset-button or Ctrl-Alt-Del the Z-80 Emulator al- 
lows you to choose one of two options. These can be seen in the prompt 
given on the screen after' pressing the reset-button on the front panel 
of the DIMENSION 68000: 

RESET has been pressed 
Press Break key to return to CP/M68K 
or Retrn key to return to EMULATION 
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To remain in the emulation mode press the RETURN key. 

When return is pressed after any reset, the Z-80 Emulator 
will act like the Z-80 CP/M system selected after the Ctrl- 
Alt-Del keys have been pressed. The Z-80 Emulator is reset. 
Some programs effectively ignore this. Some programs go to a 
special state allowing only the saving of the data and an ex- 
it. Some programs will lose any data, but the program is in- 
tact. And some programs (eg. many copy protected games) will 
attempt to "re-boot" the program, thus losing both the pro- 
gram and the data. Consult the documentation for the programs 
being used to know exactly what the results will be. 

To return to CP/M 68K press the BREAK key. 

Pressing the Break key, after any reset, will end the Z-80 
CP/M Emulator. The system will go back to CP/M 68K. Make cer- 
tain that the diskettes formatted for the Z-80 CP/M system 
are removed and CP/M 68K format diskettes are inserted. 

** When Emulation is exited, make certain that a CP/M 68K format disk- 
ette is re-installed. 

** Of course, the most obvious way to exit Emulation is to turn off the 
power to your DIMENSION 68000. This is like turning off the power 
switch on the Z-80 system selected. 
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Emulator Diskette Supports Supports Supports 
Name Format Ramdisk Async. Drives 



CPM80 40 Trk Std YES 
OSBORNEl Osborne I NO 
KAYPR02 KayPro II NO 
CR0MEM3 Cromemco NO 



NO 


A,B,C,D,E,F,G,H 


NO 


A,B 


NO 


A,B 


NO 


A,B 



CHAPTER 3 

Z-80 COPROCESSOR & EMULATORS MANUAL 



VERSION 0.00 

Page 35 



CHAPTER 



CUSTOMER SUPPORT 



CHAPTER 4 
Z-80 COPROCESSOR & EMULATORS MANUAL 



VERSION 0.00 

Page 37 

CUSTOMER SUPPORT 

The Micro Craft Corporation and its dealers are committed to providing 
you with the highest quality products and services. Micro Craft appre- 
ciates your input. If you have suggestions or comments you would like 
to make. Micro Craft welcomes them and appreciates your interest. 

IF YOU EXPERIENCE DIFFICULTY 

If you experience diffilculty, in the installation or operation of your 
Coprocessor System, your dealer and Micro Craft Corporation are availa- 
ble for assistance. There are a number of checks you may make yourself 
in order to assist your dealer or Micro Craft in solving your problem. 

DIMENSION 68000 MALFUNCTIONS AFTER COPROCESSOR INSTALLATION 

If you suspect your DIMENSION 68000 System is malfunctioning after in- 
stallation of the Z-80 Coprocessor Circuit Board, remove the board from 
the system and check operation. 

- If your DIMENSION 68000 functions properly, then the problem is most 
likely with your Coprocessor. If your Coprocessor does not function 
properly, but your DIMENSION 68000 does, then return the Coprocessor 
circuit board to your dealer (or Micro Craft) . 

- If your DIMENSION 68000 still does not function properly with the Co- 
processor removed, then there is a problem in the DIMENSION 68000 
System itself. If the symptoms, of the problem, are the not same as 
the symptoms when the Coprocessor circuit board was installed, then 
note the changes, in the symptoms, so as to help in diagnosing the 
problem. If your DIMENSION 68000 does not work, return both it and 
your Z-80 Coprocessor to your dealer. 

COPROCESSOR MALFUNCTION 

If your DIMENSION 68000 functions normally, but you suspect that your 
Coprocessor Board may be malfunctioning, there are several tests that 
you may perform yourself in order to aide in the determination of the 
problem. Record your observations in order to assist your dealer, and 
Micro Craft, in solving the problem. 

- Does the problem consistently occur with only one software package, 
or with just a few programs? If the problem occurs with only one 
program, or with just a few programs, then the problem is most likely 
an incompatability between the emulation software and your program, 
or programs. Your dealer may be able to provide assistance in recon- 
figuring the system to work with your program. 

- Do the errors or problems always occur at the same point in the pro- 
gram? 
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- Do the errors, in the program, occur in a random fashion? 

- Does the problem occur when the system has been used for an extended 
length of time? 

- Does the problem only occur with a specific copy of your program or a 
specific copy of the emulation software? If this is the case, you 
most likely have a defective diskette. 

If you have access to another DIMENSION 68000 system, try to reproduce 
the problem on that system. If the problem is unique to your system, 
the problem could be with your hardware. 

If you are unable to solve the problem yourself contact your dealer. In 
many cases, problems may be traced to defective diskettes or an impro- 
perly configured system. Your observations will greatly assist your 
dealer (and Micro Craft) in solving the problem. 

IF YOU NEED REPAIR OR ASSISTANCE... 

Your authorized Micro Craft dealer is the most expedient means of ob- 
taining repair or assistance with your Z-80 Coprocessor board, your 
DIMENSION 68000 system, or your application software. When contacting 
your dealer, please make certain that you fully describe the problem. 
If the problem only occurs under certain circumstances, then make cer- 
tain that your dealer (or Micro Craft) is told the conditions which 
created the problem. If you fail to do this, the problem may be over- 
looked and the system returned to you as it was. 

Warranty service may require proof of purchase. Save all the receipts 
in order to verify the purchase date. In addition, your receipts doc- 
ument ownership of your system for insurance purposes. 

If you are unable to contact your dealer or have moved since purchasing 
your DIMENSION 68000, contact the Micro Craft Customer Relations de- 
partment for specific instructions. Micro Craft will direct you to the 
dealer or service center closest to you. 

If it is impractical for you to return the product to a dealer. Micro 
Craft will issue a Return Materials Authorization so that you may ship 
the unit directly to the factory. Do not return any product to Micro 
Craft without a return authorization and description of the problem. 

Save ALL packing material. If you do not have the original shipping 
container. Micro Craft will provide (for a nominal charge) a shipping 
container for the DIMENSION 68000 system unit. When returning the sys- 
tem, make certain that you insure the unit for full replacement cost. 
Micro Craft is not responsible for damage or loss which occurs to the 
unit in transit. For additional information on returning equipment for 
repair, consult the Micro Craft Customer Relations department. 
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IF YOU NEED ADDITIONAL INFORMATION OR HAVE SUGGESTIONS... 

If you have suggestions for improvement or have questions about this 
documentation or any Micro Craft product we would like to hear from 
you. 

You may contact us at: 

Micro Craft Corporation 
Customer Relations Department 
4747 Irving Blvd., Suite 241 
Dallas, Texas 75247 
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